home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / XmMessageBox.z / XmMessageBox
Text File  |  1998-10-20  |  32KB  |  529 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx - The MessageBox widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////MMMMeeeessssssssaaaaggggeeeeBBBB....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           MessageBox is a dialog class used for creating simple
  20.           message dialogs.  Convenience dialogs based on MessageBox
  21.           are provided for several common interaction tasks, which
  22.           include giving information, asking questions, and reporting
  23.           errors.
  24.  
  25.           A MessageBox dialog is typically transient in nature,
  26.           displayed for the duration of a single interaction.
  27.           MessageBox is a subclass of XmBulletinBoard and depends on
  28.           it for much of its general dialog behavior.
  29.  
  30.           The default value for XXXXmmmmNNNNiiiinnnniiiittttiiiiaaaallllFFFFooooccccuuuussss is the value of
  31.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnn.
  32.  
  33.           A typical MessageBox contains a message symbol, a message,
  34.           and up to three standard default PushButtons:  OOOOKKKK,,,, CCCCaaaannnncccceeeellll,
  35.           and HHHHeeeellllpppp.  It is laid out with the symbol and message on top
  36.           and the PushButtons on the bottom.  The help button is
  37.           positioned to the side of the other push buttons.  You can
  38.           localize the default symbols and button labels for
  39.           MessageBox convenience dialogs.
  40.  
  41.           The user can specify resources in a resource file for the
  42.           gadgets created automatically that contain the MessageBox
  43.           symbol pixmap and separator.  The gadget names are "Symbol"
  44.           and "Separator".
  45.  
  46.           A MessageBox can also be customized by creating and managing
  47.           new children that are added to the MessageBox children
  48.           created automatically by the convenience dialogs.  In the
  49.           case of TemplateDialog, only the separator child is created
  50.           by default.  If the callback, string, or pixmap symbol
  51.           resources are specified, the appropriate child will be
  52.           created.
  53.  
  54.           Additional children are laid out in the following manner:
  55.  
  56.  
  57.             +o  The first MenuBar child is placed at the top of the
  58.                window.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  71.  
  72.  
  73.  
  74.             +o  All XXXXmmmmPPPPuuuusssshhhhBBBBuuuuttttttttoooonnnn widgets or gadgets, and their
  75.                subclasses are placed after the OOOOKKKK button in the order
  76.                of their creation.
  77.  
  78.             +o  A child that is not in the above categories is placed
  79.                above the row of buttons.  If a message label exists,
  80.                the child is placed below the label.  If a message
  81.                pixmap exists, but a message label is absent, the child
  82.                is placed on the same row as the pixmap.  The child
  83.                behaves as a work area and grows or shrinks to fill the
  84.                space above the row of buttons.  The layout of multiple
  85.                work area children is undefined.
  86.  
  87.  
  88.           At initialization, MessageBox looks for the following bitmap
  89.           files:
  90.  
  91.  
  92.             +o  xm_error
  93.  
  94.             +o  xm_information
  95.  
  96.             +o  xm_question
  97.  
  98.             +o  xm_working
  99.  
  100.             +o  xm_warning
  101.  
  102.  
  103.           See XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaapppp((((3333XXXX)))) for a list of the paths that are
  104.           searched for these files.
  105.  
  106.         CCCCllllaaaasssssssseeeessss
  107.           MessageBox inherits behavior and resources from CCCCoooorrrreeee,
  108.           CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr, and XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd.
  109.  
  110.           The class pointer is xxxxmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxxWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  111.  
  112.           The class name is XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx.
  113.  
  114.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  115.           The following table defines a set of widget resources used
  116.           by the programmer to specify data.  The programmer can also
  117.           set the resource values for the inherited classes to set
  118.           attributes for this widget.  To reference a resource by name
  119.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  120.           prefix and use the remaining letters.  To specify one of the
  121.           defined values for a resource in a .Xdefaults file, remove
  122.           the XXXXmmmm prefix and use the remaining letters (in either
  123.           lowercase or uppercase, but include any underscores between
  124.           words).  The codes in the access column indicate if the
  125.           given resource can be set at creation time (C), set by using
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  137.  
  138.  
  139.  
  140.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  141.           not applicable (N/A).
  142.  
  143.                                        XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  144.      NNNNaaaammmmeeee                   CCCCllllaaaassssssss                  TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                 AAAAcccccccceeeessssssss
  145.      _____________________________________________________________________________________________
  146.      XmNcancelCallback      XmCCallback            XtCallbackList   NULL                    C
  147.      XmNcancelLabelString   XmCCancelLabelString   XmString         dynamic                 CSG
  148.      XmNdefaultButtonType   XmCDefaultButtonType   unsigned char    XmDIALOG_OK_BUTTON      CSG
  149.      XmNdialogType          XmCDialogType          unsigned char    XmDIALOG_MESSAGE        CSG
  150.      XmNhelpLabelString     XmCHelpLabelString     XmString         dynamic                 CSG
  151.      XmNmessageAlignment    XmCAlignment           unsigned char    XmALIGNMENT_BEGINNING   CSG
  152.      XmNmessageString       XmCMessageString       XmString         ""                      CSG
  153.      XmNminimizeButtons     XmCMinimizeButtons     Boolean          False                   CSG
  154.      XmNokCallback          XmCCallback            XtCallbackList   NULL                    C
  155.      XmNokLabelString       XmCOkLabelString       XmString         dynamic                 CSG
  156.      XmNsymbolPixmap        XmCPixmap              Pixmap           dynamic                 CSG
  157.  
  158.  
  159.           XXXXmmmmNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk
  160.                     Specifies the list of callbacks that is called
  161.                     when the user clicks on the cancel button.  The
  162.                     reason sent by the callback is XXXXmmmmCCCCRRRR____CCCCAAAANNNNCCCCEEEELLLL.
  163.  
  164.           XXXXmmmmNNNNccccaaaannnncccceeeellllLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  165.                     Specifies the string label for the cancel button.
  166.                     The default for this resource depends on the
  167.                     locale.  In the C locale the default is "Cancel".
  168.  
  169.           XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttBBBBuuuuttttttttoooonnnnTTTTyyyyppppeeee
  170.                     Specifies the default PushButton.  A value of
  171.                     XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____NNNNOOOONNNNEEEE means that there should be no
  172.                     default PushButton.  The following are valid
  173.                     types:
  174.  
  175.  
  176.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____CCCCAAAANNNNCCCCEEEELLLL____BBBBUUUUTTTTTTTTOOOONNNN
  177.  
  178.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____OOOOKKKK____BBBBUUUUTTTTTTTTOOOONNNN
  179.  
  180.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____HHHHEEEELLLLPPPP____BBBBUUUUTTTTTTTTOOOONNNN
  181.  
  182.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____NNNNOOOONNNNEEEE
  183.  
  184.  
  185.           XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTyyyyppppeeee
  186.                     Specifies the type of MessageBox dialog, which
  187.                     determines the default message symbol.  The
  188.                     following are the possible values for this
  189.                     resource:
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  203.  
  204.  
  205.  
  206.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____EEEERRRRRRRROOOORRRR-indicates an ErrorDialog
  207.  
  208.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN-indicates an
  209.                          InformationDialog
  210.  
  211.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____MMMMEEEESSSSSSSSAAAAGGGGEEEE-indicates a MessageDialog.
  212.                          This is the default MessageBox dialog type.
  213.                          It does not have an associated message
  214.                          symbol.
  215.  
  216.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____QQQQUUUUEEEESSSSTTTTIIIIOOOONNNN-indicates a QuestionDialog
  217.  
  218.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____TTTTEEEEMMMMPPPPLLLLAAAATTTTEEEE-indicates a TemplateDialog.
  219.                          The TemplateDialog contains only a separator
  220.                          child.  It does not have an associated
  221.                          message symbol.
  222.  
  223.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____WWWWAAAARRRRNNNNIIIINNNNGGGG-indicates a WarningDialog
  224.  
  225.                       +o  XXXXmmmmDDDDIIIIAAAALLLLOOOOGGGG____WWWWOOOORRRRKKKKIIIINNNNGGGG-indicates a WorkingDialog
  226.  
  227.  
  228.                     If this resource is changed via XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss, the
  229.                     symbol bitmap is modified to the new XXXXmmmmNNNNddddiiiiaaaallllooooggggTTTTyyyyppppeeee
  230.                     bitmap unless XXXXmmmmNNNNssssyyyymmmmbbbboooollllPPPPiiiixxxxmmmmaaaapppp is also being set in
  231.                     the call to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss.  If the dialog type does
  232.                     not have an associated message symbol, then no
  233.                     bitmap will be displayed.
  234.  
  235.           XXXXmmmmNNNNhhhheeeellllppppLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  236.                     Specifies the string label for the help button.
  237.                     The default for this resource depends on the
  238.                     locale.  In the C locale the default is "Help".
  239.  
  240.           XXXXmmmmNNNNmmmmeeeessssssssaaaaggggeeeeAAAAlllliiiiggggnnnnmmmmeeeennnntttt
  241.                     Controls the alignment of the message Label.
  242.                     Possible values include the following:
  243.  
  244.  
  245.                       +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG-the default
  246.  
  247.                       +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR
  248.  
  249.                       +o  XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD
  250.  
  251.  
  252.           XXXXmmmmNNNNmmmmeeeessssssssaaaaggggeeeeSSSSttttrrrriiiinnnngggg
  253.                     Specifies the string to be used as the message.
  254.  
  255.           XXXXmmmmNNNNmmmmiiiinnnniiiimmmmiiiizzzzeeeeBBBBuuuuttttttttoooonnnnssss
  256.                     Sets the buttons to the width of the widest button
  257.                     and height of the tallest button if False.  If
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  269.  
  270.  
  271.  
  272.                     True, button width and height are set to the
  273.                     preferred size of each button.
  274.  
  275.           XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk
  276.                     Specifies the list of callbacks that is called
  277.                     when the user clicks on the OK button.  The reason
  278.                     sent by the callback is XXXXmmmmCCCCRRRR____OOOOKKKK.
  279.  
  280.           XXXXmmmmNNNNooookkkkLLLLaaaabbbbeeeellllSSSSttttrrrriiiinnnngggg
  281.                     Specifies the string label for the OK button.  The
  282.                     default for this resource depends on the locale.
  283.                     In the C locale the default is "OK".
  284.  
  285.           XXXXmmmmNNNNssssyyyymmmmbbbboooollllPPPPiiiixxxxmmmmaaaapppp
  286.                     Specifies the pixmap label to be used as the
  287.                     message symbol.
  288.  
  289.  
  290.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  291.           MessageBox inherits behavior and resources from the
  292.           following superclasses.  For a complete description of each
  293.           resource, refer to the man page for that superclass.
  294.  
  295.                                 XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  296.      NNNNaaaammmmeeee                  CCCCllllaaaassssssss                TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt         AAAAcccccccceeeessssssss
  297.      __________________________________________________________________________________
  298.      XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
  299.      XmNautoUnmanage       XmCAutoUnmanage      Boolean          True            CG
  300.      XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         CSG
  301.      XmNcancelButton       XmCWidget            Widget           Cancel button   SG
  302.      XmNdefaultButton      XmCWidget            Widget           dynamic         SG
  303.      XmNdefaultPosition    XmCDefaultPosition   Boolean          True            CSG
  304.      XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
  305.      XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
  306.      XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
  307.      XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
  308.      XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
  309.      XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG
  310.      XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
  311.      XmNnoResize           XmCNoResize          Boolean          False           CSG
  312.      XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY    CSG
  313.      XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
  314.      XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
  315.      XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
  316.      XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C
  317.  
  318.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  319.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  320.      _________________________________________________________________________________________________
  321.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  335.  
  336.  
  337.  
  338.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  339.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  340.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  341.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  342.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  343.      XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
  344.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  345.      XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
  346.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  347.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  348.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  349.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  350.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  351.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  352.  
  353.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  354.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  355.      ______________________________________________________________________
  356.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  357.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  358.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  359.  
  360.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  361.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  362.      ______________________________________________________________________________________________________________
  363.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
  364.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  365.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  366.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  367.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  368.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  369.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  370.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  371.      XmNdepth                        XmCDepth                        int              dynamic                CG
  372.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  373.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  374.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  375.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  376.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  377.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  378.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  379.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  380.      XmNx                            XmCPosition                     Position         0                      CSG
  381.      XmNy                            XmCPosition                     Position         0                      CSG
  382.  
  383.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  384.           A pointer to the following structure is passed to each
  385.           callback:
  386.  
  387.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  388.           {{{{
  389.             iiiinnnntttt          _r_e_a_s_o_n;;;;
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  401.  
  402.  
  403.  
  404.             XXXXEEEEvvvveeeennnntttt       * _e_v_e_n_t;;;;
  405.           }}}} XXXXmmmmAAAAnnnnyyyyCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  406.  
  407.  
  408.           _r_e_a_s_o_n Indicates why the callback was invoked
  409.  
  410.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback
  411.  
  412.  
  413.         TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
  414.           XmMessageBox includes the translations from XmManager.
  415.  
  416.         AAAAddddddddiiiittttiiiioooonnnnaaaallll BBBBeeeehhhhaaaavvvviiiioooorrrr
  417.           The XmMessageBox widget has the additional behavior
  418.           described below:
  419.  
  420.  
  421.           MMMMAAAAnnnnyyyy KKKKCCCCaaaannnncccceeeellll:
  422.                     Calls the activate callbacks for the cancel button
  423.                     if it is sensitive.
  424.  
  425.           KKKKAAAAccccttttiiiivvvvaaaatttteeee:
  426.                     Calls the activate callbacks for the button with
  427.                     the keyboard focus.  If no button has the keyboard
  428.                     focus, calls the activate callbacks for the
  429.                     default button if it is sensitive.
  430.  
  431.           <<<<OOOOkkkk BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  432.                     Calls the callbacks for XXXXmmmmNNNNooookkkkCCCCaaaallllllllbbbbaaaacccckkkk.
  433.  
  434.           <<<<CCCCaaaannnncccceeeellll BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  435.                     Calls the callbacks for XXXXmmmmNNNNccccaaaannnncccceeeellllCCCCaaaallllllllbbbbaaaacccckkkk.
  436.  
  437.           <<<<HHHHeeeellllpppp BBBBuuuuttttttttoooonnnn AAAAccccttttiiiivvvvaaaatttteeeedddd>>>>:
  438.                     Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk.
  439.  
  440.           <<<<FFFFooooccccuuuussssIIIInnnn>>>>:
  441.                     Calls the callbacks for XXXXmmmmNNNNffffooooccccuuuussssCCCCaaaallllllllbbbbaaaacccckkkk.
  442.  
  443.           <<<<MMMMaaaapppp>>>>:    Calls the callbacks for XXXXmmmmNNNNmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  444.                     parent is a DialogShell.
  445.  
  446.           <<<<UUUUnnnnmmmmaaaapppp>>>>:  Calls the callbacks for XXXXmmmmNNNNuuuunnnnmmmmaaaappppCCCCaaaallllllllbbbbaaaacccckkkk if the
  447.                     parent is a DialogShell.
  448.  
  449.  
  450.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  451.           The bindings for virtual keys are vendor specific.  For
  452.           information about bindings for virtual buttons and keys, see
  453.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV          XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX))))
  467.  
  468.  
  469.  
  470.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  471.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))),
  472.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeEEEErrrrrrrroooorrrrDDDDiiiiaaaalllloooogggg((((3333XXXX)))),
  473.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeIIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxx((((3333XXXX)))),
  474.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeMMMMeeeessssssssaaaaggggeeeeDDDDiiiiaaaalllloooogggg((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeQQQQuuuueeeessssttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333XXXX)))),
  475.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeTTTTeeeemmmmppppllllaaaatttteeeeDDDDiiiiaaaalllloooogggg((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeWWWWaaaarrrrnnnniiiinnnnggggDDDDiiiiaaaalllloooogggg((((3333XXXX)))),
  476.           XXXXmmmmCCCCrrrreeeeaaaatttteeeeWWWWoooorrrrkkkkiiiinnnnggggDDDDiiiiaaaalllloooogggg((((3333XXXX)))), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))), and
  477.           XXXXmmmmMMMMeeeessssssssaaaaggggeeeeBBBBooooxxxxGGGGeeeettttCCCChhhhiiiilllldddd((((3333XXXX)))).
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.